home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / os20 / wb / cpuctrl.lha / CPU-Control.doc < prev    next >
Text File  |  1992-07-07  |  8KB  |  182 lines
  1. --------------------------------------------------------------------------
  2.                         CPU-Control 1.3a (7-Jul-92)
  3. --------------------------------------------------------------------------
  4.  
  5. CPU-Control  is  a  CPU-like utility for Kickstart/WB 2.0 including a GUI.
  6. The  main  difference  to  other  tools  of this kind is, that CPU-Control
  7. recognizes  external  changes  of  any of its parameters.  Because of this
  8. special  feature it needs some CPU-Time (not much), but in iconified state
  9. it needs no processor time at all.  Additionally CPU-Control allows moving
  10. VBR  (VectorBaseRegister)  to  Fast-RAM, which significantly speeds up all
  11. Traps/Interupts.   Many  CLI  Options have been included to allow usage in
  12. scripts,  so it's a good idea to put "CPU-Control vbr nw" in your Startup-
  13. Sequence.
  14.  
  15. --------------------------------------------------------------------------
  16.                                Requirements
  17. --------------------------------------------------------------------------
  18.  
  19. Amiga-OS 2.04 or higher is required to run CPU-Control.
  20.  
  21. --------------------------------------------------------------------------
  22.                                 CLI Usage
  23. --------------------------------------------------------------------------
  24.  
  25. Parameter      Shortform     Effect                             CPU needed
  26. --------------------------------------------------------------------------
  27. (none)                       just starts CPU-Control
  28. ICACHE            I          enable  Instruction Cache            68020+
  29. NOICACHE          NI         disable Instruction Cache            68020+
  30. DCACHE            D          enable  Data Cache                   68030+
  31. NODCACHE          ND         disable Data Cache                   68030+
  32. IBURST            IB         enable  Instruction Burst            68030
  33. NOIBURST          NIB        disable Instruction Burst            68030
  34. DBURST            DB         enable  Data Burst                   68030
  35. NODBURST          NDB        disable Data Burst                   68030
  36. VBR                          move VBR to FastRAM                  68010+
  37. NOVBR                        normal VBR (Zero)                    68010+
  38. COPYBACK          CB         enable  Copyback                     68040
  39. NOCOPYBACK        NCB        disable Copyback                     68040
  40. MMU                          enable  FastROM/SafeKick        | 68020/851 |
  41. NOMMU                        disable FastROM/SafeKick        |  or 68030 |
  42. MOVESSP           SSP        move SSP to FastRAM
  43. VERBOSE           V          Verbose output
  44. CHECK                        check for a specified processor
  45.                              (68010/68020/68030/68040/68881/68882/FPU/MMU)
  46. ICONIFY           IC         starts iconified
  47. NOWIN             NW         starts without GUI
  48. CCI                          Chip-Cache-Inhibit (see update notes)
  49.  
  50. Example: CPU-Control I D IB NDB VBR SSP MMU V NW
  51.  
  52.          enables all Caches,  enables IBurst,  disables DBurst,  moves VBR
  53.          and SSP  to FastMem,  enables the MMU  (FastROM or SafeKick)  and 
  54.          prints the new status verbosely without opening the GUI.
  55.  
  56. --------------------------------------------------------------------------
  57.                               Technical Info
  58. --------------------------------------------------------------------------
  59.  
  60. CPU-Control  has been developed using HiSoft's wonderful DevPac 3.02.  The
  61. GUI  was  designed using  GadToolsBox 1.3, but the code was so bad, that I
  62. decided to rewrite it.
  63.  
  64. All  cache  manipulations are done using Exec's CacheControl, VBR movement
  65. is  done  by  allocating  1024 Bytes of memory using AllocMem, copying the
  66. area,  and then setting the VBR register to the new value.  Enforcer would
  67. complain  about  this,  but you can simply ignore it.  Just for safety the
  68. routine  in  embedded  in Forbid/Permit, and Caches are cleared via Exec's
  69. CacheClearU.
  70.  
  71. The  MMU  option automagically selects FastROM-mode for ROM-Kickstarts and
  72. SafeKick-mode  for Kickstarts  loaded by ZKick/LKick ($200000).  It is NOT
  73. compatible to the WB-2.0 "CPU" command, because the MMU-Table used is much
  74. more  efficient, and in addition to "CPU" it write-protects the RAM-image.
  75. Alien-MMU-Activations  make the "Safe/Fast OS" gadget unavailable, and the
  76. Verbose  CLI mode  will show up "(MMU)", which means the MMU is active but
  77. incompatible to CPU-Control.  And again:  Ignore Enforcer!
  78. _LVOColdReboot  will  be  patched on MMU-activation in order to switch off
  79. the  MMU  before resetting.  A BusError-Handler makes the RAM-image behave
  80. like a real ROM.
  81.  
  82. 68020's without MMU (68851) and 68EC030 (68030-Light) should be recognized
  83. correctly.
  84.  
  85. While the full GUI is open, CPU-Control uses a Delay/GT_GetIMsg loop to be
  86. able to recognize changes of the Cache/VBR. In iconified (zoomed) state it
  87. uses Exec's Wait without using any processor time.
  88.  
  89. The MOVESSP option should only be used in Startup-Sequences, because it is
  90. a  quite  dangerous  operation.   SSP will only be moved, if there is REAL
  91. FastRAM  available and SSP is currently in SlowRAM.  This operation is not
  92. reversible.
  93.  
  94. --------------------------------------------------------------------------
  95.                                Future Plans
  96. --------------------------------------------------------------------------
  97.  
  98. - FastROM and SafeKick options with 68040 support
  99.   Beta-Testers with 68040 wanted!
  100.  
  101. - Tooltypes
  102.  
  103. - Cache-Inhibit for Commodore's PC/AT-Bridgeboards
  104.  
  105. - (any more ideas?)
  106.  
  107. --------------------------------------------------------------------------
  108.                                  History
  109. --------------------------------------------------------------------------
  110.  
  111. 1.0     -       initial release:  8-May-92
  112.  
  113. 1.1     -       release date:    13-May-92
  114.  
  115.                 - many serious bugs (hopefully) fixed
  116.                 - overall code optimisation
  117.                 - added 68020/851 and 68030 MMU support
  118.                 - added "ICONIFY" option
  119.  
  120. 1.2     -       release date:    14-May-92
  121.  
  122.                 - added CHECK option to test for a specified processor
  123.                   Example: CPU-Control check 68030
  124.                            will produce an ErrorCode 5 if not found
  125.                   CHECK always activates the NOWIN option
  126.                 - cleaned-up menu layout
  127.  
  128. 1.3     -       release date:    16-May-92
  129.  
  130.                 - added MOVESSP option to allow moving the Supervisor
  131.                   Stackpointer to fast memory
  132.                 - CLI mode (especially CHECK) can now be used on 68000
  133.                 - minor code cleanup
  134.  
  135. 1.3a    -       release date:     7-Jul-92
  136.  
  137.                 - Cache-Inhibit for ChipRAM is no longer set automatically
  138.                   because every well-behaving hardware (including A3000
  139.                   and A2620/30 Turboboards) does this already.
  140.                   In addition operation in ChipRAM is slightly faster now,
  141.                   because the hardwired solution effects Datacache only.
  142.                   In case of trouble the CCI option (CLI only!) could be
  143.                   used to enable Cache-Inhibit. Of course this option is
  144.                   only useful if used together with the MMU option.
  145.  
  146.  
  147.                 ATTENTION: If the main progamm file doesn't have a length
  148.                            of 5644 Bytes it is DAMAGED!
  149.  
  150. --------------------------------------------------------------------------
  151.                                 Shareware
  152. --------------------------------------------------------------------------
  153.  
  154.                         CPU-Control is SHAREWARE!
  155.  
  156.         If you use this program for a longer period than one week,
  157.             please send me a donation of 10 US$ or equivalent!
  158.  
  159.                       So if you want more tools like
  160.                CPU-Control, TagScreens, UnArp and Safekick
  161.               think about it and keep developers developing.
  162.  
  163.                                 THANK YOU!
  164.  
  165.  
  166.                       Registered-User-Counter: 00001
  167.  
  168. --------------------------------------------------------------------------
  169.                                   Author
  170. --------------------------------------------------------------------------
  171.  
  172.                  Send bug-reports and/or suggestions to:
  173.  
  174.                               Martin Berndt
  175.                            Fr.-Alfred-Str. 115
  176.                              4100 Duisburg 14
  177.                                  Germany
  178.  
  179. --------------------------------------------------------------------------
  180.  
  181. (End of this wonderful document)
  182.